home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1996 March
/
EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso
/
earcd
/
comm2
/
ftp-mail.lha
/
FTP-Mail
/
ftp-mail.dok
< prev
next >
Wrap
Text File
|
1995-11-26
|
22KB
|
580 lines
----------------------------------------------------------------------------
For englisch DOC's use the command "HELP ftp-mail.doc"!
Um die wichtigsten Hilfsdateien von FTP-MAIL zu erhalten benutze bitte
das Kommando "HELPALL".
Schreibe einfach eine E-Mail an ftp@<domain>
mit dem Subject oder Text HELPALL
Dieses Kommando sendet Dir wichtige Hilfsdateien zu (auch diese
Anleitung)!
----------------------------------------------------------------------------
FTP-MAIL.DOK
(c) 1994 von Alexander Aulbach
Verantwortlichkeit: Siehe Disclaimer.doc! Benutze das Kommando "HELP
disclaimer.doc" um es über FTP-Mail zu erhalten!
----------------------------------------------------------------------------
Wichtiger Hinweis:
------------------
Sei vorsichtig mit diesem Programm! Es ist damit möglich sehr grosse
E-Mails zu versenden! Die Kosten solcher Sendungen können für die Sysops
und/oder Domänen vor Dir sehr hoch werden!
MISSBRAUCHE DIESES PROGRAMM NIEMALS, UM FLAME-MAILS, BOMB-MAILS ODER
ÄHNLICHE DINGE ZU ERZEUGEN.
----------------------------------------------------------------------------
Was ist das?
------------
FTP-MAIL ist ein Programm um automatisch Dateien über E-Mail zu versenden.
Z.B. kann man damit Archive oder andere Dinge über E-Mail verschicken.
FTP-MAIL ist für Sites programmiert, die spezielle Dateien führen (z.B.
spezielle CD-ROMS oder - wie ich - eine große Menge an Samples) und diese
allgemein zugaenglich machen wollen, aber keine BBS eröffnen wollen,
sondern nur RFC-Anbindung ans Internet besitzen.
FTP-MAIL ist ebenfalls für BBS'en programmiert, die ihren Usern einen
weiteren Service anbieten wollen. In der Regel ist es so, daß im
Reginalbereich einer BBS beim täglichen pollen immer Gebühreneinheiten
verschenkt werden. Dieser Freiraum kann mit FTP-Mail teilweise genutzt
werden.
FTP-MAIL ist auch gedacht um Hilfsdateien zu versenden. So ist es sicher
eine gute Idee für ein UUCP-System diesen Dämon für die daran
angeschlossenen Pollsites bzw. Unterdomänen zu installieren, damit diese
die neuesten Informationen über Dein System erhalten, sowie damit neue
User automatische Hilfe zur Verfügung gestellt bekommen.
----------------------------------------------------------------------------
Grundsätzliches:
----------------
o E-MAIL-ADRESSE:
FTP-MAIL reagiert auf E-Mails, die Du an das Programm schickst!
Um eine E-Mail an das System zu senden kannst Du folgende User verwenden:
ftp, ftp-mail, mail-server and ftp-mail-server.
BEISPIELADRESSE: ftp-mail@ssilkyway.incubus.sub.org
FTP-MAIL benutzt als Rücksendeadresse (Reply-To:) "ftp-mail-daemon"! Das
ist aus dem Grund, weil sonst im Extremfall zwei Daemonen sich gegenseitig
ständig Mails zusenden (das ist der Nachteil an automatisierten
Verfahren).
o LOGFILE:
FTP-MAIL sendet immer ein Logfile zurück, das Deine ORIGINAL MAIL und alle
Aktionen die Du ausgelößt hast und wie sie interpretiert wurden.
AUSNAHME 1: Wenn FTP-MAIL das Kommando NOLOGFILE findet sendet es das
Logfile nicht zurueck.
AUSNAHME 2: Nach einem PUT-Kommando werden nur die nächsten 2 Zeilen
gesendet, danach wir das zurücksenden abgebrochen.
AUSNAHME von AUSNAHME 1: Falls ein Fehler Auftritt.
Für jedes ausgeführte Kommando HELP, DIR, LIST, LS und GET bekommst Du
eine extra E-Mail!
o WIE FTP-MAIL DEINE E-MAIL LIEST:
FTP-MAIL liest die komplette Mail! Auch die Header und die Signatur werden
gescannt. Durch das END-Kommando kann dies verhindert werden.
Wenn die "Subject:"-Zeile ein Kommando beinhaltet, dann wird dies
ebenfalls interpretiert (siehe auch ALIASES)!
Groß- und Kleinschrift ist egal. FTP-MAIL konvertiert alle Kommandos in
GROSSSCHRIFT.
FTP-MAIL scant Zeilen bis zu einer Länge von 64 Kb - das ist die maximale
Länge eines Arexx-Strings.
o WIE FTP-MAIL INTERPRETIERT:
FTP-MAIL versteht nur Kommandos und Argumente, etwa so:
<Kommando> <Argument>
^^^ ^^^
Erstes Wort Rest der Zeile (nach dem Whitespace) wird als Argument genommen
BEISPIEL: help ftp-paths.config
Ein Kommando muß das erste Wort einer Zeile sein! Ein Wort besteht aus
einem oder mehr Zeichen, getrennt durch ein Whitespace (Leerzeichen oder
Tab).
Leerzeichen links oder rechts vom Argument werden gelöscht!
FTP-MAIL schaut nur nach diesen Kommandos! Andernfalls wird die komplette
Zeile ignoriert (Ausnahme sind Aliase).
PS: Du kannst Anführungszeichen (<">) im Argumentteil benutzen. (Fuer
Insider: Sie werden korrekt übersetzt für die DOS-Scripte in <*">!)
BEISPIELE: GET Usr:sounds/effects/Alex' cry
GET Usr:sounds/voices/Say "Aaaaaah"
o KOMMANDO BEGRENZER:
FTP-MAIL schaut nach "|" (ASCII 124) in einer Zeile. Dieses Zeichen ist
der Kommando-Begrenzer. Für FTP-MAIL ist es, als ob eine neue Zeile
beginnen würde. Du kannst so viele Kommandos in eine Zeile setzen, wie Du
willst (bis zu 65536 Zeichen pro Zeile).
AUSNAHME: Nach einem gefundenem PUT oder END-Kommando wird der Rest der
Zeile nicht weitergescannt!
o WIE ALIASE ARBEITEN:
Wenn ein Kommando nicht gefunden wurde, dann schaut FTP-MAIL in die Datei
"ftp-alias.config" nach Aliasen. Sie werden nach folgender Regel ersetzt:
URSPRUNG: <alteskommando> <altesargument>
ERGEBNIS: <neueskommando> <neuesargument> <altesargument>
BEISPIEL:
SUBJECT: HELPALL -> wird ersetzt durch
HELPALL -> wird ersetzt durch
HELP | ALIASES | PATHS | MODES | MAXIMUM
vvvvvvv
ALIASES -> wird ersetzt durch
HELP ftp-aliases.config
und so weiter!
Du kannst die komplette Liste der verfügbaren ALIASE erhalten, mit dem
Kommando "HELP ftp-aliases.config" oder einfach "ALIASES" - welches ein
Alias auf dieses Kommando ist. :-)
Aliase können auch mehr als ein Kommando sein (siehe auch Kommando
Begrenzer "|").
o EINSCHRÄNKUNGEN:
- FTP-MAIL führt nur die ersten 500 Kommandos (nicht Zeilen!) einer
E-Mail aus. (Ich denke, das ist genug :-).
- Es werden keine rekursiven Aliase unterstützt. Irgenwann läuft dann halt
die Zeile voll und das Programm bricht ordentlich mit einem Fehler ab,
wobei der FTP-Postmaster informiert wird.
- Der FTP-Postmaster des Systems kann FTP-MAIL die maximale Länge der zu
übertragenden Dateien mitteilen. Du kannst diese maximale Länge
erhalten, indem Du das Kommando "HELP ftp-maxtransfer.config" oder
einfach "MAXIMUM" oder "MAXTRANSFER" aufrufst.
- Es gibt leider noch keinen Mode, um lange E-Mails zu splitten. :(
- Der FTP-Postmaster des Systems muß FTP-MAIL die Domains mitteilen, denen
erlaubt ist ftp-mail zu erhalten. Du kannst diese Information mit dem
Kommando "HELP ftp-domains-lvl<X>.config" erhalten, wobei <X> eine Zahl
zwischen 0 und Maximum-integer ist.
FTP-MAIL prüft den Empfänger (Reply-To:!) der Mail auf einen Teilstring
in "ftp-domains-lvl<X>.config".
o SICHERHEIT
Die Sicherheit von ftp-mail ist und bleibt sehr beschränkt! ES IST MÖGLICH
DAS PROGRAMM DURCH FALSCHE ADRESSEN ZU MISBRAUCHEN! Darum erhält der
ftp-postmaster auch stets eine Kopie des Logfiles. Aber im Rahmen des
normalen Mailverkehrs kann man ftp-mail eine relativ gute Sicherheit
bescheinigen. Das Programm wurde über ein Jahr im Dauerbetrieb auf einer
großen Mailbox getestet und es kam zu keinen Problemen.
----------------------------------------------------------------------------
Bekannte Kommandos:
-------------------
HELP - Sendet eine KURZE englische Hilfe.
HELP - HELP <dateiname>. Sendet dateiname. Der Dateiname sollte mit ".doc",
".dok", ".config" oder ".list" enden, andernfalls wird ein ".doc"
hinzugefügt. Eine Liste von anderen verfügbaren Dokumetationen über
diesen Dämon und anderen Hilfen wird am Ende des jeweiligen
Dokuments angefügt. Eine jeweilige Hilfsdatei und die Liste der
verfügbaren Dateien wird nur einmal pro Session gesendet.
AUSNAHME: Die Liste der verfügbaren Dokumentationen wird nicht
gesendet, wenn FTP-MAIL das NOFILEHELP-Kommando gefunden
hatte.
BEISPIELE: HELP ftp-mail ---> sendet die englische Version dieser
Hilfsdatei (".doc" wird automatisch
angefügt)
HELP ftp-aliases.config
---> sendet config/ftp-aliases.config
("config/" wird automatisch
hinzugefügt, wenn die Datei mit
".config" endet!)
HELP ftp-mail ---> wird nicht gesendet, weil es bereits
einmal während dieser Session
gesendet wurde.
CD - CD <vollerpfad>
CD <relativerpfad>
Change Directory. Der Parameter gibt den vollständigen Pfad an, auf
den man wechseln möchte. Pfad wird auf Gültigkeit überprüft,
ungültige CD-Wünsche werden komplett ignoriert. Das heißt, daß ein
fehlgeschlagenes CD-Kommando den Pfad auf dem vorherigen Pfad beläßt.
BEISPIELE VOLLSTÄNDIGER PFADE:
CD Usr:Sounds/cords
CD USR:sounds/DRUMS/
CD Usr:SOunds/Drums/Hihats/
BEISPIELE RELATIVER PFADE:
Das erste CD-Kommando muß ein vollständiger Pfad sein!
CD Usr:Sounds/cords
CD / ---> Pfad ist jetzt Usr:Sounds
(Elternverzeichnis)
CD effects ---> Pfad ist jetzt Usr:Sounds/effects
CD : ---> Pfad ist jetzt Usr:
(Oberste Geräteebene,
Wurzelverzeichnis)
(ist aber nicht in
ftp-paths.config erlaubt und
wird ignoriert!)
Das erste CD-Kommando muß ein vollständiger Pfad sein.
Du kannst eine vollständige Liste aller verfügbaren Pfade mit dem
Kommando "HELP ftp-paths.config" oder einfach "PATHS" erhalten.
LIST
LS
DIR - LIST, LS, DIR
LIST <vollerpfad>, LS <vollerpfad>, DIR <vollerpfad>
Du mußt ein gültiges CD-Kommando senden, bevor Du die
Verzeichnisinhalte auflisten kannst. Du erhälst eine Liste, aller
Dateien in diesem Pfad. Wie diese Listen aussehen können steht
weiter unten!
Um die Sache abzukürzen ist es möglich ein Argument für DIR, LS
oder LIST zu übergeben. In einem solchen Fall versucht FTP-MAIL
selbständig vorher ein CD-Kommando zu machen. Der Mechanismus ist
nahezu der gleiche, wie im GET-Kommando (siehe dort).
BEISPIELE:
DIR
allritebeet axelerashenloop
Bongo-Snap Bongo-Snap.info
China-R-C China-R-H
China-Rythm digunddoof
...
LS
-----rwed 82 41284 Dez 23 1991 Usr:Sounds/Beats/allritebeet
/* Rythmus */
-----rwed 27 13492 Aug 10 1992 Usr:Sounds/Beats/Bongo-Snap
/* Rythmus */
-----rwed 98 49452 Jan 11 1994 Usr:Sounds/Beats/China-R-C
/* Rythmus */
-----rwed 98 49432 Jan 11 1994 Usr:Sounds/Beats/China-R-H
/* Rythmus */
...
Totals:
Dirs:0 Files:41 Blocks:2015 Bytes:1017158
LIST
09-Feb-92 20280 "Usr:Sounds/Beats/Hypnotist" Rythmus
17-Dez-91 42732 "Usr:Sounds/Beats/Hypnotist hart" Rythmus
10-Aug-92 494 "Usr:Sounds/Beats/Bongo-Snap.info" Rythmus
17-Dez-91 15104 "Usr:Sounds/Beats/Loop 1" Rythmus
17-Dez-91 25028 "Usr:Sounds/Beats/loop 1 131Bpm" Rythmus
17-Dez-91 25408 "Usr:Sounds/Beats/Loop 10" Rythmus
17-Dez-91 14788 "Usr:Sounds/Beats/Loop 2" Rythmus
17-Dez-91 27536 "Usr:Sounds/Beats/loop 2 128Bpm" Rythmus
17-Dez-91 25432 "Usr:Sounds/Beats/Loop 3" Rythmus
...
LISTALL
LSALL
DIRALL - LISTALL, LSALL, DIRALL
LISTALL <vollerpfad>, LSALL <vollerpfad>, DIRALL <vollerpfad>
Das sind die gleichen Kommandos, wie oben, nur werden hier die
Unterverzeichnisse rekursiv aufgelistet!
BEISPIEL für DIR:
Beats (dir)
allritebeet axelerashenloop
beat1 beat10
beat2 beat3
...
MODE - MODE <mode>.
Der Modus teilt dem Dämon mit, welche Programme aufgerufen werden,
bevor die Mail gesendet wird (oder upgelodet)
BEISPIEL: MODE LHA-UUENCODE
Voreingestellter Modus ist: UUENCODE
Du kannst eine komplette Liste aller verfügbaren Modis mit dem
Kommando "HELP ftp-modes.config" erhalten. Mit dem Kommando "MODES"
kann man diese Datei und alle dazugehörigen Scripte erhalten.
Es ist möglich den Modus während einer Session mehrmals zu
wechseln. Die GET und PUT-Kommandos beziehen sich stets auf das
zuletzt gesendete MODE-Kommando. Das hat evtl. Sinn, je nach der
Art der Dateien, die Empfangen werden.
GET - Get <dateiname>
Get <vollerpfad><dateiname>
Du must vorher ein gültiges CD-Kommando senden, oder dem
GET-Kommando einen vollständigen Pfad mitteilen (Hinweis: die erste
Scan-Routine entscheidet, ob ein vollstaendiger Pfad vorliegt, wenn
ein ":" im Parameter auftaucht).
Ein einmal gesendetes File wird nicht nochmals während einer
Session gesendet.
ACHTUNG: Aus historischen Gründen ist es leider so, daß ein
GET <vollerpfad><dateiname> durch zwei einzelne Kommandos
(CD <vollerpfad> und GET <dateiname>) ersetzt wird.
Diesen Umstand bitte bei der Wahl der Kommandoaufrufe
berücksichtigen! Ein einmal gesetzter Pfad bleibt also
stets bestehen bis zum nächsten _gültigen_ CD-Kommando.
BEISPIEL: GET Usr:sounds/Beats/honey nut loops
GET loop 2 | # der gesetzte Pfad bleibt bestehen!
GET Usr:Sounds/drums/woods/Block
Das File wird mit dem gesetzen Modus eingepackt und verschickt.
Bitte beachte auch den E-Mail-header, der in der gleichen Mail
mitgeschickt wird. Alles, um diese Mail ähnlich wie FTP-MAIL
automatisch auszuwerten wird in den X-Headern mitgeschickt!
PUT - Dies ist ein spezielles Kommando!
Wenn Du etwas an dieses System senden willst, dann mußt Du einige
spezielle Zeilen in Deine E-Mail einfügen!
Du MUST folgende Zeilen irgendwo in der Mail mit einem Inhalt
spezifizieren:
X-PATH: <Pfad, der in der Datei ftp-upload-paths.config existiert>
X-NAME: <Name der Datei>
X-COMMENT: <Filekommentar zu dieser Datei>
X-LENGTH: <Original Länge>
FTP-MAIL KANN NUR EIN PUT-KOMMANDO PRO SESSION (E-MAIL)
VERARBEITEN! Alles NACH dem PUT-Kommando wird verworfen und
nicht ausgeführt (FTP-MAIL nimmt an, daß das File, das Du an den
Dämon senden willst normalerweise direkt hinter dem PUT-Kommando
anfängt).
Für den Anfang können nur uuencodete Dateien gesendet werden (siehe
MODES!). X-LENGHT ist in diesem Zusammenhang die Länge der Datei
VOR/NACH uuen/decoding. Diese Länge muß stimmen - sie ist sozusagen
eine zusaetzliche Prüfsumme.
Weitere Schlüsselwörter und Kommandos:
END - Der Rest der E-Mail wird überlesen. Gut bei zufällig
erzeugten Signaturen (wozu eigentlich überhaupt Signaturen
senden bei automatisch gelesenen E-Mails?).
NOLOGFILE - Ich glaube, das ist einfach zu verstehen: Dieses Kommando
unterdrückt das Zurücksenden des Logfiles.
AUSNAHME: Wenn ein größerer Fehler auftritt (FTP-MAIL kam in
Schwierigkeiten), dann wird das Logfile
zurückgesendet!
NOFILEHELP - Dieses Kommando unterdrückt das Anfügen der Liste der
verfügbaren Hilfsdateien am Ende der ersten Hilfsdatei.
MESSAGE-ID: - Wenn Du mehr als eine Mail am Tag an den Dämon sendest. Damit
sieht man, welches Logfile zu welcher dazugehörigen Mail
gehört. Dieses Kommando kann pro Session nur einmal ausgeführt
werden, weil mehr als eine MESSAGE-ID: in einer Mail macht
wenig Sinn.
DATE: - Datum deines Postens. Dieses Kommando wird nur einmal
ausgeführt.
FROM: - Voreingestellte Rücksendeadresse (Falls REPLY-TO: nicht
angegeben wird)
REPLY-TO: - Rücksende Adresse. Es ist manchmal praktisch die Daten nicht
an den normalen Mailfolder zurücksenden zu lassen. Ich habe
bei mir Beispielsweise ein Programm installiert, das die von
FTP-MAIL gesendeten Dateien automatisch auspackt und richtig
mit Kommentaren versieht..
BEISPIEL:
REPLY ftpget@ssilkyway.mayn.sub.de
^^^^^ --> "REPLY-TO:" hat den Alias "REPLY"!
FTP-MAIL nimmt immer die zuletzt gefundene REPLY-TO:-Adresse
für die komplette Mail.
Wenn REPLY-TO: nicht gefunden wird, dann wird das FROM:-Argument
genommen.
leere Zeilen
# - Kommentare, die nicht weiter beachtet werden.
Beispiel: # this is only a silly comment
# ^^^ this line before too! :-)
Nur im Zusammenhang mit dem PUT-Kommando:
X-PATH: - Pfad, der in der Datei ftp-upload-paths.config existiert
X-NAME: - Name der Datei
X-COMMENT: - Filekommentar zu dieser Datei
X-LENGTH: - Original Länge
----------------------------------------------------------------------------
Wichtige Aliase:
----------------
HELPALL -> "HELP | HELPME | ALIASES | PATHS | MODES | MAXIMUM"
Das sendet Dir diese wichtigen Hilfsdateien!
Siehe auch Kommando Begrenzer um es zu verstehen!
HELPME -> "HELP ftp-mail.doc"
Sendet englische Anleitung.
HILFMIR -> "HELP ftp-mail.dok"
Sendet DIESE Anleitung.
ALIASES -> "HELP ftp-aliases.config"
Dieses Kommando sendet Dir die Alias-Liste.
So gibt es benutzerdefinierte Aliase in ihr (z.B. das
Senden einer Liste mit allen Dateien, die auf diesem System
verfügbar sind).
PATHS -> "HELP ftp-paths.config"
Sendet eine Liste aller verfügbaren Pfade, von denen Du Files
holen kannst (nur bei Level-0-Benutzern).
MODES -> "HELP ftp-modes.config | HELP config/.uuencode.list | HELP
config/.lha-uencode.list | HELP config/.raw.list | HELP
config/.uudecode.list"
Sendet eine Liste aller Verfügbaren Modis und die
dazugehörigen Script-Dateien. Die Modis und was sie bewirken
ist in dieser Liste beschrieben. Die Namen nach den Modis
sind die DOS-Skripte, die aufgerufen werden, um die Modies
auszuführen.
MAXIMUM or
MAXTRANSFER -> "HELP ftp-maxtransfer.config"
Sendet die maximale Länge einer GET-Anfrage. GET arbeitet
nicht, wenn eine Datei größer als diese Angabe ist.
REPLY -> "REPLY-TO:"
Einfachere Angabe für REPLY-TO: Kommando.
SUBJECT: -> ""
Das ersetzt das "Subject:" einer Mail durch nichts! Siehe
auch Ersetzungsmechanismus der Aliase weiter oben, um es zu
verstehen. Mit diesem Alias kann man Kommandos in die
Subject:-Zeile schreiben!
----------------------------------------------------------------------------
Beispiel E-Mail:
----------------
> From ssilk Sat, 20 Aug 94 11:36:49 CED
> Received: by ssilkyway.mayn.sub.de (wUUCP 1.10)
> id <05bn@ssilkyway.mayn.sub.de>; Sat, 20 Aug 94 11:36:49 CED
> Date: Sat, 20 Aug 94 11:36:49 CED
> Message-Id: <9408201135.05bn@ssilkyway.mayn.sub.de>
> X-Mailer: //\\miga Electronic Mail (AmiElm 2.253)
> X-PATH: Usr:ftp-mail
> X-NAME: readme.doc
> X-COMMENT: The readme to FTP-MAIL-DAEMON
> X-LENGTH: 405
> Organization: Semmelstreet
> Reply-To: ssilk@ssilkyway.mayn.sub.de
> Content-Length: 692
> From: ssilk@ssilkyway.mayn.sub.de (Alexander Aulbach)
> To: ssilkftp@ssilkyway.mayn.sub.de
> Subject: HELPALL
>
> GET usr:sounds/beats/loop 4
>
> List | PUT | REPLY ftp_receiver@ssilkyway
> MODE RAW ; GET loop 2
>
> begin 777 readme.doc
> M"@I214%$344M1DE24U0N1$]#"@I7:&%T(&ES(&ET/PHM+2TM+2TM+2TM+0H*X
> M1E10+4U!24P@:7,@82!P<F]G<F%M('1O('1R86YS9F5R(&%U=&]M871I8V%LX
> M;'D@9FEL97,@=FEA($4M36%I;"X@22X@92X@=&AA= IY;W4@8V%N(&]R9&5RX
> M(&%R8VAI=F5S(&%N9"!O=&AE<B!S='5F9B!V:6$@12U-86EL+@H*1E10+4U!X
> M24P@:7,@979E;B!T:&]U9VAT(&9O<B!T<F%N<V9E<B!O9B!H96QP+69I;&5SX
> M+B!3;R!I="!C;W5L9"!B92!A(&=O;V0*:61E82!F;W(@82!554-0+7-Y<W1EX
> M;2!T;R!I;G-T86QL('1H:7,@9&%E;6]N(&9O<B!T:&4@<W5B9&]M86EN<RP@X
> M=&AA="!T:&5Y"F-A;B!G970@=&AE(&YE=V5S="!I;F9O<FUA=&EO;B!A8F]UX
> M="!Y;W5R('-Y<W1E;2!A;F0@<V]M92!H96QP(&9O<B!N97<*=7-E<G,N"@H*X
> X
> end
>
>
Die REPLY-, MODE- und GET-Kommandos werden nicht ausgeführt, weil alle
Kommandos nach dem PUT-Kommando nicht gelesen werden.
Tschau und viel Spass mit FTP-MAIL!